home *** CD-ROM | disk | FTP | other *** search
mmmmbbbbssssttttrrrriiiinnnngggg((((3333CCCC)))) mmmmbbbbssssttttrrrriiiinnnngggg((((3333CCCC)))) NNNNAAAAMMMMEEEE _mmmm_bbbb_ssss_tttt_rrrr_iiii_nnnn_gggg: _mmmm_bbbb_ssss_tttt_oooo_wwww_cccc_ssss, _wwww_cccc_ssss_tttt_oooo_mmmm_bbbb_ssss, _wwww_cccc_ssss_xxxx_ffff_rrrr_mmmm - multibyte string functions SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_tttt_dddd_llll_iiii_bbbb_...._hhhh_>>>> _ssss_iiii_zzzz_eeee______tttt _mmmm_bbbb_ssss_tttt_oooo_wwww_cccc_ssss _((((_wwww_cccc_hhhh_aaaa_rrrr______tttt _****_pppp_wwww_cccc_ssss_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_ssss_,,,, _ssss_iiii_zzzz_eeee______tttt _nnnn_))))_;;;; _ssss_iiii_zzzz_eeee______tttt _wwww_cccc_ssss_tttt_oooo_mmmm_bbbb_ssss _((((_cccc_hhhh_aaaa_rrrr _****_ssss_,,,, _cccc_oooo_nnnn_ssss_tttt _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_pppp_wwww_cccc_ssss_,,,, _ssss_iiii_zzzz_eeee______tttt _nnnn_))))_;;;; _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_wwww_cccc_hhhh_aaaa_rrrr_...._hhhh_>>>> _ssss_iiii_zzzz_eeee______tttt _wwww_cccc_ssss_xxxx_ffff_rrrr_mmmm _((((_wwww_cccc_hhhh_aaaa_rrrr______tttt _****_wwww_ssss_1111_,,,, _cccc_oooo_nnnn_ssss_tttt _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_wwww_ssss_2222_,,,, _ssss_iiii_zzzz_eeee______tttt _nnnn_))))_;;;; DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN _mmmm_bbbb_ssss_tttt_oooo_wwww_cccc_ssss converts a sequence of multibyte characters from the array pointed to by _s into a sequence of corresponding wide character codes and stores these codes into the array pointed to by _p_w_c_s, stopping after _n codes are stored or a code with value zero (a converted null character) is stored. If _p_w_c_s is a null pointer, _mmmm_bbbb_ssss_tttt_oooo_wwww_cccc_ssss returns the length required to convert the entire array regardless of the value of _n, but no values are stored. _wwww_cccc_ssss_tttt_oooo_mmmm_bbbb_ssss converts a sequence of wide character codes from the array pointed to by _p_w_c_s into a sequence of multibyte characters and stores these multibyte characters into the array pointed to by _s, stopping if a multibyte character would exceed the limit of _n total bytes or if a null character is stored. If _s is a null pointer, _wwww_cccc_ssss_tttt_oooo_mmmm_bbbb_ssss returns the length required to convert the entire array regardless of the value of _n, but no values are stored. This function returns the number of bytes required for the character array. _wwww_cccc_ssss_xxxx_ffff_rrrr_mmmm transforms the wide character string pointed to by _w_s_2 and places the resulting wide character string into the array pointed to by _w_s_1 . The transformation is such that if _wwww_cccc_ssss_cccc_mmmm_pppp is applied to two transformed wide strings, it returns a value greater than, equal to or less than _0000, corresponding to the result of _wwww_cccc_ssss_cccc_oooo_llll_llll applied to the same two original wide character strings. No more than _n wide-character codes are placed into the resulting array pointed to by _w_s_1 , including the terminating null wide-character code. If _n is _0000, _w_s_1 is permitted to be a null pointer. If copying takes place between objects that overlap, the behaviour is undefined. _wwww_cccc_ssss_xxxx_ffff_rrrr_mmmm returns the length of the transformed wide character string (not including the terminating null wide-character code). If the value returned is _n or more, the contents of the array pointed to by _w_s_1 are indeterminate. SSSSEEEEEEEE AAAALLLLSSSSOOOO _wwww_cccc_hhhh_rrrr_tttt_bbbb_llll(1M), _mmmm_bbbb_cccc_hhhh_aaaa_rrrr(3C), _ssss_eeee_tttt_llll_oooo_cccc_aaaa_llll_eeee(3C), _wwww_cccc_ssss_cccc_mmmm_pppp(3S), _wwww_cccc_ssss_cccc_oooo_llll_llll(3S), _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5), _<<<<_wwww_cccc_hhhh_aaaa_rrrr_...._hhhh_>>>>. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS If an invalid multibyte character is encountered, _mmmm_bbbb_ssss_tttt_oooo_wwww_cccc_ssss returns (_ssss_iiii_zzzz_eeee______tttt)-1 with _eeee_rrrr_rrrr_nnnn_oooo set equal to _EEEE_IIII_LLLL_SSSS_EEEE_QQQQ. Otherwise, _mmmm_bbbb_ssss_tttt_oooo_wwww_cccc_ssss returns the number of array elements modified, not including the terminating zero code, if any. PPPPaaaaggggeeee 1111 mmmmbbbbssssttttrrrriiiinnnngggg((((3333CCCC)))) mmmmbbbbssssttttrrrriiiinnnngggg((((3333CCCC)))) If a wide character code is encountered that does not correspond to a valid multibyte character, _wwww_cccc_ssss_tttt_oooo_mmmm_bbbb_ssss returns (_ssss_iiii_zzzz_eeee______tttt)-1 with _eeee_rrrr_rrrr_nnnn_oooo set equal to _EEEE_IIII_LLLL_SSSS_EEEE_QQQQ. Otherwise, _wwww_cccc_ssss_tttt_oooo_mmmm_bbbb_ssss returns the number of bytes modified, not including a terminating null character, if any. On error, _wwww_cccc_ssss_xxxx_ffff_rrrr_mmmm returns _((((_ssss_iiii_zzzz_eeee______tttt_))))_----_1111 and sets _eeee_rrrr_rrrr_nnnn_oooo to indicate the error. If the wide character string pointed to by _w_s_2 contains wide- character codes outside the domain of the collating sequence, then _eeee_rrrr_rrrr_nnnn_oooo is set to _EEEE_IIII_NNNN_VVVV_AAAA_LLLL. PPPPaaaaggggeeee 2222 
